home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / jlimit_startjob.z / jlimit_startjob
Encoding:
Text File  |  2002-10-03  |  4.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. jjjjlllliiiimmmmiiiitttt____ssssttttaaaarrrrttttjjjjoooobbbb((((3333cccc))))                                        jjjjlllliiiimmmmiiiitttt____ssssttttaaaarrrrttttjjjjoooobbbb((((3333cccc))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      jlimit_startjob - creates a new job container
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////rrrreeeessssoooouuuurrrrcccceeee....hhhh>>>>
  13.  
  14.      jjjjiiiidddd____tttt    jjjjlllliiiimmmmiiiitttt____ssssttttaaaarrrrttttjjjjoooobbbb((((cccchhhhaaaarrrr ****uuuusssseeeerrrrnnnnaaaammmmeeee,,,, uuuuiiiidddd____tttt uuuuiiiidddd,,,, cccchhhhaaaarrrr ****ddddoooommmmaaaaiiiinnnnnnnnaaaammmmeeee))));;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      The _j_l_i_m_i_t__s_t_a_r_t_j_o_b function performs all of the tasks necessary to
  18.      creating a new job.
  19.  
  20.      The function takes the _u_s_e_r_n_a_m_e, the user's ID (_u_i_d), and job limits
  21.      _d_o_m_a_i_n_n_a_m_e as arguments and returns the newly created job's job ID.
  22.  
  23.      A list of domains may also be passed to the _j_l_i_m_i_t__s_t_a_r_t_j_o_b function.
  24.      This allows a batch scheduler to have a unique job limits domain.  The
  25.      example below shows a domain list for the Miser batch processing system:
  26.  
  27.           jid = jlimit_startjob("bsmith", 7777, "miser:batch");
  28.  
  29.  
  30.      The domain list is a colon-delimited list ("_m_i_s_e_r:_b_a_t_c_h").  The
  31.      _jjjj_llll_iiii_mmmm_iiii_tttt______ssss_tttt_aaaa_rrrr_tttt_jjjj_oooo_bbbb function starts with the first domain on the left; in
  32.      this case, _m_i_s_e_r.  If the _m_i_s_e_r domain does not exist, then
  33.      _jjjj_llll_iiii_mmmm_iiii_tttt______ssss_tttt_aaaa_rrrr_tttt_jjjj_oooo_bbbb will try _b_a_t_c_h.
  34.  
  35.      To create a new job, the calling process must have CAP_SETUID and
  36.      CAP_PROC_MGT capability.  See the capabilities(4) man page for more
  37.      information on the capability mechanism that provides fine grained
  38.      control over the privileges of a process.
  39.  
  40.      The _j_l_i_m_i_t__s_t_a_r_t_j_o_b function retrieves the job limit and process
  41.      information from the ULDB and populates those limits into the job
  42.      structure.
  43.  
  44. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  45.      showlimits(1), getjlimit(2), makenewjob(2).
  46.  
  47. EEEERRRRRRRROOOORRRRSSSS
  48.      Under the following conditions, the function _j_l_i_m_i_t__s_t_a_r_t_j_o_b fails and
  49.      set _e_r_r_n_o to:
  50.  
  51.      [ENOPKG]       The job limits software is not installed.
  52.  
  53.      [EINVAL]       The _mmmm_aaaa_kkkk_eeee_nnnn_eeee_wwww_jjjj_oooo_bbbb(2) system call returns an invalid argument
  54.                     to the _j_l_i_m_i_t__s_t_a_r_t_j_o_b function.
  55.  
  56. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  57.      Upon successful completion, _j_l_i_m_i_t__s_t_a_r_t_j_o_b returns a job ID.  If an
  58.      error occurs, a value of -1 is returned and eeeerrrrrrrrnnnnoooo is set to indicate the
  59.      error.  If job limits software is not installed, _j_l_i_m_i_t__s_t_a_r_t_j_o_b returns
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. jjjjlllliiiimmmmiiiitttt____ssssttttaaaarrrrttttjjjjoooobbbb((((3333cccc))))                                        jjjjlllliiiimmmmiiiitttt____ssssttttaaaarrrrttttjjjjoooobbbb((((3333cccc))))
  71.  
  72.  
  73.  
  74.      a value of 0.
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.